Installing on Solaris

Prior to installation it is recommended that you review the Installation components section to determine what components you will require. Installation instructions for each component are provided below. 

 

ZIP Console Installation

 

To install using the ZIP file perform the following steps as a user with root privileges. If you plan on running MFT Gateway as a non-root user under Solaris 10 or above, please consult the topic Auto-starting in Solaris 10 environments topic before continuing.

 

 

  1. Place the gateway_install.zip file in a directory on the destination server.


  2. Install. Run the following command from the directory containing the ZIP file you placed on your server:

 

unzip gateway_install.zip


  1. Configure and initialize database. Go to the MFT Gateway installation directory relative to where the unzip command was executed, and run the following commands:


    ./database -configure

    ./database -init


  2. Add administrative user.  Go to the MFT Gateway installation directory relative to where the unzip command was executed, and run the following command:

 

./add-administrator -username [username] -password [password] -email [email]

 

For example:

 

./add-administrator -username admin -password secret -email admin@redwood.com

 

This will configure MFT Gateway, where [username] and [password] are the administrative credentials you will use when connecting to the service using the MFT Gateway Manager. The MFT Gateway Manager is the web-based application that is part of an installation of MFT Gateway. It is the user interface used to configure and manage your MFT Gateway environment.

 

  1. Startup MFT Gateway Service. If you are auto-starting using an SMF script you may skip this step.  From the MFT Gateway installation directory run the following command:


    ./gateway start

 

or

 

./start_service.sh

 

See Accessing the user interface - MFT Gateway Manager to configure and manage MFT Gateway.

 

 

  1. Place the gateway_agent_install.zip file in a directory on the destination server.

 

  1. Install. Run the following command from the directory containing the ZIP file you placed on your server:

 

unzip gateway_agent_install.zip

 

  1. Enable control channel for MFT Gateway. See Agent service for details.

 

  1. Set agent connection settings. See Adding agents for details. Go to the MFT Gateway Agent installation directory relative to where the unzip command was executed.

     

    If you do not have an MFT Gateway failover configured, run the following command:

     

    ./configuration -host [ip] -port [port] -user [username] -password [password]

     

    For example:

     

    ./configuration -host 10.0.0.1 -port 30025 -user admin -password secret

     

    If you do have an MFT Gateway failover configured, run the following command:

 

./configuration -host [ip] -port [port] -user [username] -password [password] -failover.host[ip] -failover.port [port]

  

For example:

 

./configuration -host 10.0.0.1 -port 30025 -user admin -password secret -failover.host 10.0.0.2 -failover.port 30126

 

Note about failover: The failover host and port provided are used when a connection is severed between the MFT Gateway instance and the MFT Gateway Agent, and a connection cannot be re-established (within 3 attempts). The Agent log will reflect any failover attempts - e.g. Connection to agent service on <host>:<port> failed. Attempting connection to next available host <host>:<port>.

  

In both cases, this will configure MFT Gateway Agent, where [ip] and [port]are the control channel IP and port for MFT Gateway and [username] and [password] are administrative credentials you will use when connecting to the control channel.

 

  1. Startup MFT Gateway Agent Service. From the MFT Gateway Agent installation directory run the following command:


    ./agent start